FilterFOLVK 0.1.1  -  Prime Entity
Dual stereo filter bank

WHAT IT IS
    Two stereo filters with fifty-eight types between them - slopes, analog
    ladders, formants, phasers, combs, EQs, FM and lo-fi - in series, in
    parallel or split across left and right. Two LFOs, a step sequencer, an
    envelope follower and an oscillator move them through an eight-slot
    modulation matrix, and a saturation and delay / reverb stage finishes it.

    Two plug-ins, one licence:
        FilterFOLVK          the effect - put it on any channel
        FilterFOLVK Synth    the instrument - play it from MIDI

INSTALLING
    Easiest:  open FilterFOLVK-0.1.1.pkg and follow the steps.

    By hand:  the two .vst3       -> ~/Library/Audio/Plug-Ins/VST3/
              the two .component -> ~/Library/Audio/Plug-Ins/Components/
              the two .app       -> /Applications/

    Quit your DAW completely before testing - a running host keeps the
    previous plug-in binary in memory.

    Ableton:  Preferences > Plug-Ins > Rescan
    Logic:    validates the Audio Units on next launch

    The plug-ins appear as:  Prime Entity  >  FilterFOLVK
                             Prime Entity  >  FilterFOLVK Synth

FIRST LAUNCH
    The installer is not signed with an Apple Developer ID, so macOS will
    say it is from an unidentified developer. Right-click the .pkg and
    choose Open, then confirm. You only need to do this once.

    If you copy the plug-ins in by hand from this archive, clear the
    quarantine flag macOS puts on downloaded files:

        xattr -cr ~/Library/Audio/Plug-Ins/VST3/FilterFOLVK*.vst3
        xattr -cr ~/Library/Audio/Plug-Ins/Components/FilterFOLVK*.component

THE MANUAL
    FilterFOLVK Manual.pdf, in this folder.

REMOVING IT AGAIN
    Double-click "Uninstall FilterFOLVK.command". It shows what it will
    remove and asks before touching anything, and asks separately before
    deleting your presets and licence.

    If macOS refuses to open it because it came from an unidentified
    developer, right-click it and choose Open. Or clear the flag:

        xattr -cr "Uninstall FilterFOLVK.command"

    It removes FilterFOLVK and FilterFOLVK Synth only. Other Folvk plug-ins
    are left alone.

PRESETS AND YOUR LICENCE
    ~/Documents/Prime Entity/FilterFOLVK/Presets

    Created the first time you open the plug-in, and shared by the effect
    and the synth. A preset is every setting in the plug-in, and it is a
    plain file - back them up, or send one to somebody. Your .folvklicense
    goes in the folder above Presets.

A NOTE ON LEVELS
    Resonance near the top makes the ladders and steep filters ring on
    their own. That is the sound, not a fault - but turn the filter's
    Level down before you push it. A safety limit stops the output at
    +12 dBFS so it can never run away.
